home *** CD-ROM | disk | FTP | other *** search
/ Nebula 1 / Nebula One.iso / Internet / FTP / Mirror2.3 / README < prev    next >
Encoding:
Text File  |  1994-01-28  |  3.0 KB  |  83 lines
  1. Mirror is a package written in Perl that uses the ftp protocol to
  2. duplicate a directory hierarchy between the machine it is run on and a
  3. remote host.  It avoids copying files unnecessarily by comparing the
  4. file timestamps and sizes before transfering.  Amongst other things
  5. can optionally compress, gzip, and split files.
  6.  
  7. It was written for use by archive maintainers but can be used by
  8. anyone wanting to transfer a lot of files over ftp.
  9.  
  10.  
  11. INSTALLATION:
  12. You *may* need to change the values of $extra_path and $big_temp at
  13. the start of mirror.pl.  This is very unlikely but possible.
  14.  
  15. If your system limits the length of a file name a lot then also look for:
  16.     LIMITED NAMELEN
  17. which is about 75% of the way thru mirror.pl.  I only know of one site using
  18. this.
  19.  
  20.  
  21. IF INSTALLING MIRROR JUST FOR ARCHIVE MAINTENANCE:
  22.  
  23. Normally pick a directory that you want to run mirror from.  Unravel the tar
  24. image in that directory.  Edit the mirror.defaults to reflect local settings.
  25.  
  26. IF YOU ARE PLANNING ON MAKING MIRROR AVAILABLE AS A USER COMMAND:
  27.  
  28. Install into a publically accessible lib area (for example
  29. /usr/local/lib/mirror) and add a symlink from a suitable bin area to
  30. the mirror.pl in the lib directory.  It this is not possible given
  31. your local setup install all the .pl scripts into a lib area that will
  32. be scanned by perl and install the binary in a suitable bin.
  33.  
  34.  
  35. If h2ph has been run for your system then you should probably remove
  36. socket.ph and use the one *meant* for your machine.  If h2ph has not
  37. been run then you should persuade your systems administrators to do
  38. so.  The contents of socket.ph are operating system specific and it is
  39. possible that what works for me will not work for you.
  40.  
  41. A special note for Solaris 2.x users.  The socket.ph created by h2ph doesn't
  42. work.  Install the socket.ph-solaris from this distribution instead.
  43.  
  44. There seems to be a problem with older versions of perl that causes
  45. mirror to fail with the message 'fstype unix unknown'.  If you experience
  46. this then please upgrade your perl.  The latest perl can be found in
  47. src.doc.ic.ac.uk:gnu/perl-4.036.tar.gz  (the exact version number may
  48. be different).
  49.  
  50. AVAILABILITY:
  51. The latest version of mirror is available from:
  52.  
  53.     src.doc.ic.ac.uk [146.169.2.1]
  54.         directory: computing/archiving/mirror
  55.         (shortcut packages/mirror)
  56.     
  57.         ftp.th-darmstadt.de [130.83.55.75]
  58.             directory: pub/networking/mirror
  59.  
  60.  
  61.     ftp.sun.ac.za [146.232.212.2]
  62.         directory: pub/packages/mirror
  63.  
  64.  
  65. RELATED:
  66. Mirror is part of a family of related programs.  The others are ftpmail
  67. and ftpcat.  Ftpmail is a mail responder and ftpcat cats a remote file.
  68. These are to be found in src.doc.ic.ac.uk:packages/ftpmail/
  69. and packages/ftpcat/.
  70.  
  71. If you are interested in developing mirror (not just getting the
  72. latest releases but actually doing work) there is a mailing list
  73. mirror-people@doc.ic.ac.uk.  Subscribe by emailing to
  74. mirror-people-request@doc.ic.ac.uk.   But please do NOT do this unless you
  75. have the time to work on mirror.
  76.  
  77.  
  78.  
  79.  
  80. REMEMBER:
  81.  
  82. Objects in a mirror are closer than you think!
  83.